home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / fatal14.zip / FATAL.DOC < prev    next >
Text File  |  1989-12-25  |  8KB  |  217 lines
  1.  
  2.                               F A T A L
  3.                    Resident Critical Error Handler
  4.  
  5.                              FATAL14.ZIP
  6.                             v1.4 12-26-89
  7.  
  8.                     Copyright 1989 Samuel H. Smith
  9.                           All rights reserved.
  10.  
  11.  
  12. This program is a resident (TSR) utility that traps critical errors and
  13. attempts to handle them in an intelligent way.  It replaces the normal
  14. "Retry, Ignore, Abort" prompt.
  15.  
  16. It draws on all available information to present a complete error
  17. description to the user.  If the operator does not respond within 10
  18. seconds the program will automatically take the action suggested by DOS.
  19.  
  20. DOS version 3.0 or later is required to use this program.
  21. Once resident, FATAL used about 3800 bytes of RAM.
  22.  
  23.  
  24. Usage:
  25.    FATAL/I     ;install FATAL in memory.
  26.  
  27.    FATAL/U     ;un-install, remove FATAL from memory.
  28.  
  29.    FATAL/C     ;display critical error counters.
  30.  
  31.    FATAL/Z     ;reset error counters to zero.
  32.  
  33.  
  34. The FATAL program will take over critical errors that are not directly
  35. handled in a later program.  It is careful to preserve any replacement
  36. error handler used by an application program.  Because of this, it is
  37. advised to load FATAL as an early TSR, before any others that also set
  38. up critical error handlers.  In multi-tasking systems you may need to
  39. load a copy of FATAL into each memory partition.
  40.  
  41.   NOTE: If you are running the LANtastic network, you must load FATAL
  42.         *before* calls to SERVER and probably also before REDIR and
  43.         LANBIOS. Otherwise a sharing violation will be trapped on the
  44.         server rather than on the offending workstation!
  45.  
  46. Example output
  47. --------------
  48.  
  49. FATAL/I
  50.    FATAL v1.4 installed.
  51.  
  52. FATAL/U
  53.    FATAL unInstalled.
  54.  
  55. FATAL/C
  56.    FATAL v1.4 status:
  57.       10 Critical errors.
  58.        5 Automatic retries.
  59.    Error:
  60.        3 Seek error!
  61.        6 Sharing violation!
  62.        1 Network device no longer exists!
  63.    Class:
  64.        3 Hardware failure
  65.        6 Resource locked
  66.        1 Unknown
  67.    Locus:
  68.        1 Unknown.
  69.        8 Block device (disk error).
  70.        1 Network.
  71.    Drive:
  72.        2 I:
  73.        6 J:
  74.        2 U:
  75.    Area:
  76.        5 Directory area.
  77.        5 Data area.
  78.    Suggested action:
  79.        3 Retry the operation.
  80.        6 Delay and then retry.
  81.        1 Re-enter input.
  82.  
  83.  
  84.   ╔═══════════════════╡ CRITICAL ERROR! ╞════════════════════╗                  
  85.   ║  Error: Drive not ready!                                 ║                  
  86.   ║  Area:  Reading from drive A: File allocation table.     ║                  
  87.   ║  Class: Hardware failure in Block device (disk error).   ║                  
  88.   ║  Suggested action: Retry after correcting the error.     ║                  
  89.   ╚══════════════════════════════════════════════════════════╝                  
  90.      Action: (A)bort, (R)etry, (I)gnore, (F)ail? <R>
  91.  
  92. FATAL/Z
  93.    Critical error counters zeroed.
  94.  
  95.  
  96.                                    LICENSE
  97.                                    =======
  98.  
  99.    SourceWare: What is it?
  100.    -----------------------
  101.  
  102.    SourceWare is my name for a unique concept in user supported
  103.    software.
  104.  
  105.    Programs distributed under the SourceWare concept always offer source
  106.    code.
  107.  
  108.    This package can be freely distributed so long as it is not modified 
  109.    or sold for profit.  If you find that this program is valuable, you
  110.    can send me a donation for what you think it is worth.  I suggest
  111.    about $10.
  112.  
  113.    Send your registrations to:        The Tool Shop BBS
  114.       Samuel H. Smith                 (602) 264-3969 (2400) - Free node
  115.       5119 N. 11th Ave., #332         (602) 279-2673 (HST 9600)
  116.       Phoenix AZ 85013                (602) 279-0230 (HAYES 9600)
  117.  
  118.  
  119.    Why SourceWare?
  120.    ---------------
  121.    Why do I offer source code?  Why isn't the donation manditory?  The
  122.    value of good software should be self-evident.  The source code is
  123.    the key to complete understanding of a program.  You can read it to
  124.    find out how things are done.  You can also change it to suit your
  125.    needs, so long as you do not distribute the modified version without
  126.    my consent.
  127.  
  128.  
  129.    Copyright
  130.    ---------
  131.    If you modify this program,  I would appreciate a copy of the new
  132.    source code.  I am holding the copyright on the source code,  so
  133.    please don't delete my name from the program files or from the
  134.    documentation.
  135.  
  136.  
  137.                                 DISCLAIMER
  138.                                 ==========
  139.    I make no warranty of any kind, express or implied, including without
  140.    limitation, any warranties of merchantability and/or fitness for a
  141.    particular purpose.  I shall not be liable for any damages, whether
  142.    direct, indirect, special or consequential arising from a failure of
  143.    this program to operate in the manner desired by the user.  I shall
  144.    not be liable for any damage to data or property which may be caused
  145.    directly or indirectly by the use of this program.
  146.  
  147.    IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY
  148.    LOST PROFITS,  LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL
  149.    DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR
  150.    FOR ANY CLAIM BY ANY OTHER PARTY.
  151.  
  152.  
  153.  
  154. Revision History
  155. ----------------
  156.  
  157. 7-20-89 v1.0
  158.    Initial coding and release.
  159.  
  160.  
  161. 7-31-89 v1.1
  162.    Changed all display code to use BIOS calls exclusively.  The initial
  163.    version used the DOS function 9, but this caused problems when
  164.    standard output was redirected: the FATAL messages were also
  165.    redirected!
  166.  
  167.    Added screen save and restore operations; original user screen is now
  168.    preserved after fatal error processing (text modes only).  BIOS calls
  169.    are used for compatibility with all system types.
  170.  
  171.    Corrected an error that caused application program error handlers to
  172.    be replaced.  FATAL is supposed to replace only the standard handler,
  173.    leaving application error handlers in place.
  174.  
  175.  
  176. 8-2-89 v1.2
  177.    Changed keyboard input functions to use BIOS calls rather than DOS
  178.    calls.  This prevents a crash if standard input has been redirected
  179.    from a file at the time a critical error takes place.
  180.  
  181.    Slight reduction in RAM requirement.
  182.  
  183.    FATAL now removes itself from memory if run a second time.  Please
  184.    don't do this if you have any resident programs loaded after FATAL.
  185.  
  186.    Added /L command line option to bypass license messages.
  187.  
  188.  
  189. 8-14-89 v1.3
  190.    Added internal counters for number of critical errors and number of
  191.    automatic retries.  Each possible error message is counted for later
  192.    reporting.
  193.  
  194.    New FATAL/C option produces a detailed report of all error counters.
  195.  
  196.    New FATAL/I option performs initial installation.
  197.  
  198.    New FATAL/U option un-installs fatal if possible.
  199.  
  200.    Fatal now hooks the DOS services interrupt in addition to the timer
  201.    tick interrupt.  On very fast machines it was possible to miss a
  202.    critical error during the first 55 miliseconds of program execution.
  203.  
  204.  
  205. 12-26-89 v1.4
  206.    Shortened automatic retry delay from 30 seconds to 10 seconds.
  207.  
  208.    New FATAL/Z option to zero all error counters.
  209.  
  210.    Added new logic to properly handle nested calls to COMMAND.COM and
  211.    shells to COMMAND.COM from application programs.
  212.  
  213.    Improved the ability of FATAL/C to locate the resident portion, even
  214.    when being called by an application that takes over the critical
  215.    error interrupt.
  216.  
  217.